Skip to content

New functionalities of Storage.Pickers: SettingsIdentifier; InitialFileTypeIndex; Title; PickMultipleFoldersAsync; ShowOverwritePrompt;#6052

Merged
DinahK-2SO merged 24 commits intomainfrom
user/DinahK-2SO/feature_settingsidentifier_filetypefilterindex
Jan 24, 2026
Merged

New functionalities of Storage.Pickers: SettingsIdentifier; InitialFileTypeIndex; Title; PickMultipleFoldersAsync; ShowOverwritePrompt;#6052
DinahK-2SO merged 24 commits intomainfrom
user/DinahK-2SO/feature_settingsidentifier_filetypefilterindex

Conversation

@DinahK-2SO
Copy link
Contributor

@DinahK-2SO DinahK-2SO commented Dec 3, 2025

Implementation for

This pull request updates the Storage.Pickers API implementation to add new customization and usability features to the FileOpenPicker, FileSavePicker, and FolderPicker classes. The changes introduce properties for dialog title and instance-specific settings, allow specifying the default file type filter by 0-based index, and add support for picking multiple folders. These enhancements are reflected in both the API definitions and usage examples.

Adds properties:

Title

  • Adds Title properties to FileOpenPicker, FileSavePicker, and FolderPicker, enabling custom dialog titles.

Related:

SettingsIdentifier

  • Adds SettingsIdentifier properties to FileOpenPicker, FileSavePicker, and FolderPicker, enabling instance-specific picker state across sessions.

Related:

InitialFileTypeIndex

  • Adds InitialFileTypeIndex property to FileOpenPicker and FileSavePicker, allowing developers to set the default selected file type filter by index (0-based).

Related:

Changes in FileSavePicker

  • Adds a new properties for FileSavePicker: ShowOverwritePrompt:
    ShowOverwritePrompt default to true and control whether the picker warns about overwriting when user picked an existing file via FileSavePicker.

  • Changing the default behavior - when the user picked a not-existing file via FileSavePicker, the picker will NOT create an empty file there - allowing developer to decide when to make this file.

Related:

Adds method:

FolderPicker.PickMultipleFoldersAsync

  • Adds PickMultipleFoldersAsync method to FolderPicker, enabling selection of multiple folders in a single operation. API definitions, documentation, and code samples have been updated to reflect this feature.

Related:

@DinahK-2SO DinahK-2SO changed the title New functionalities of Storage.Pickers: SettingsIdentifier; FileTypeIndex; Title; FolderPicker.PickMultipleFoldersAsync New functionalities of Storage.Pickers: SettingsIdentifier; FileTypeIndex; Title; PickMultipleFoldersAsync; ShowOverwritePrompt; CreateNewFileIfNotExists Dec 4, 2025
@DinahK-2SO DinahK-2SO force-pushed the user/DinahK-2SO/feature_settingsidentifier_filetypefilterindex branch from 2efb906 to 852aa73 Compare December 24, 2025 09:11
@DinahK-2SO DinahK-2SO marked this pull request as ready for review January 21, 2026 05:31
@DinahK-2SO DinahK-2SO force-pushed the user/DinahK-2SO/feature_settingsidentifier_filetypefilterindex branch from 852aa73 to 5b22d3e Compare January 21, 2026 05:37
@DinahK-2SO DinahK-2SO marked this pull request as draft January 21, 2026 05:43
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Copy link
Contributor

@yeelam-gordon yeelam-gordon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Functionality review comments for PR 6052.

@yeelam-gordon
Copy link
Contributor

/azp run

@azure-pipelines
Copy link

Azure Pipelines successfully started running 1 pipeline(s).

@DinahK-2SO
Copy link
Contributor Author

/azp run

@azure-pipelines
Copy link

Azure Pipelines successfully started running 1 pipeline(s).

Dinah Xiaomgao G and others added 2 commits January 24, 2026 02:26
@DinahK-2SO
Copy link
Contributor Author

/azp run

@azure-pipelines
Copy link

Azure Pipelines successfully started running 1 pipeline(s).

@DinahK-2SO
Copy link
Contributor Author

/azp run

@azure-pipelines
Copy link

Azure Pipelines successfully started running 1 pipeline(s).

@Scottj1s Scottj1s self-requested a review January 23, 2026 18:49
DinahK-2SO added a commit that referenced this pull request Jan 24, 2026
…ngsIdentifier; FileTypeIndex; Title; PickMultipleFoldersAsync; ShowOverwritePrompt (#6051)

API Spec for
- #6052

## Adds properties:

### Title

* Adds `Title` properties to `FileOpenPicker`, `FileSavePicker`, and `FolderPicker`, enabling custom dialog titles. 

Related:
- #5879

### SettingsIdentifier
* Adds `SettingsIdentifier` properties to `FileOpenPicker`, `FileSavePicker`, and `FolderPicker`, enabling instance-specific picker state across sessions. 

Related:
- #5847
- microsoft/microsoft-ui-xaml#10904

### FileTypeIndex

* Adds `FileTypeIndex` property to `FileOpenPicker` and `FileSavePicker`, allowing developers to set the default selected file type filter by index (0-based).

Related:
- #5975

### Changes in FileSavePicker
* Adds a new properties for `FileSavePicker`: `ShowOverwritePrompt`:
  `ShowOverwritePrompt` default to `true` and control whether the picker warns about overwriting when user picked an existing file via FileSavePicker.

* Changing the default behavior - when the user picked a not-existing file via FileSavePicker, the picker will NOT create an empty file there - allowing developer to decide when to make this file.

Related:
- #5976

## Adds method:

### FolderPicker.PickMultipleFoldersAsync

* Adds `PickMultipleFoldersAsync` method to `FolderPicker`, enabling selection of multiple folders in a single operation. API definitions, documentation, and code samples have been updated to reflect this feature.

Related:
- #5848
@DinahK-2SO DinahK-2SO enabled auto-merge (squash) January 24, 2026 03:31
@DinahK-2SO DinahK-2SO changed the title New functionalities of Storage.Pickers: SettingsIdentifier; FileTypeIndex; Title; PickMultipleFoldersAsync; ShowOverwritePrompt; CreateNewFileIfNotExists New functionalities of Storage.Pickers: SettingsIdentifier; FileTypeIndex; Title; PickMultipleFoldersAsync; ShowOverwritePrompt; Jan 24, 2026
@DinahK-2SO DinahK-2SO merged commit 0f919de into main Jan 24, 2026
36 checks passed
@DinahK-2SO DinahK-2SO deleted the user/DinahK-2SO/feature_settingsidentifier_filetypefilterindex branch January 24, 2026 04:08
@DinahK-2SO DinahK-2SO changed the title New functionalities of Storage.Pickers: SettingsIdentifier; FileTypeIndex; Title; PickMultipleFoldersAsync; ShowOverwritePrompt; New functionalities of Storage.Pickers: SettingsIdentifier; InitialFileTypeIndex; Title; PickMultipleFoldersAsync; ShowOverwritePrompt; Jan 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants